home *** CD-ROM | disk | FTP | other *** search
/ Languguage OS 2 / Languguage OS II Version 10-94 (Knowledge Media)(1994).ISO / gnu / gas_251.zip / bin_251 / binutils / README < prev    next >
Text File  |  1994-09-29  |  4KB  |  96 lines
  1. This is a beta release of a completely rewritten binutils distribution.
  2. (Rewritten since binutils 1.x, that is.)
  3.  
  4. The linker (ld) has been moved into a separate directory, which should be
  5. ../ld.  Linker-specific notes are in ../ld/README.
  6.  
  7. As of version 2.5, the assembler (as) is also included in this package, in
  8. ../gas.  Assembler-specific notes can be found in ../gas/README.
  9.  
  10. These programs have been tested on various architectures.
  11. However, since this is a beta release taken directly from an
  12. evolving source tree, there might be some problems.  In particular,
  13. the programs have not been ported to as many machines as the
  14. old binutils.  There are also features of the old versions
  15. that are missing on the new programs.  We would appreciate
  16. patches to make things run on other machines; especially welcome
  17. are fixes for what used to work on the old programs!
  18. (See ./TODO, as well a ../bfd/TODO and ../ld/TODO.)
  19.  
  20. Recent changes are in ./NEWS, ../ld/NEWS, and ../gas/NEWS.
  21.  
  22. Unpacking and Installation -- quick overview
  23. ==========================
  24.  
  25. In this release, the binary utilities, the linker, the generic GNU include
  26. files, the BFD ("binary file description") library, gprof, and getopt all
  27. have directories of their own underneath the binutils-2.5 directory.
  28. The idea is that a variety of GNU tools can
  29. share a common copy of these things.  Configuration scripts and
  30. makefiles exist to cruise up and down this directory tree and
  31. automatically build all the pieces in the right order.
  32.  
  33. When you unpack the binutils-2.5.tar.gz file, you'll get a directory
  34. called something like `binutils-2.5', which contains:
  35.  
  36.     COPYING          bfd/             configure*       libiberty/
  37.     COPYING.LIB      binutils/        configure.in     move-if-change*
  38.     CYGNUS           build-all.mk     etc/             opcodes/
  39.     ChangeLog        config/          gprof/           test-build.mk
  40.     Makefile.in      config.guess*    inc
  41.  
  42. To build binutils, you can just do:
  43.  
  44.     cd binutils-2.5
  45.     ./configure [ --enable-targets='target1,target2...' ]
  46.     make
  47.     make install # copies the programs files into /usr/local/bin
  48.              # by default.
  49.  
  50. This will configure and build all the libraries as well as binutils
  51. and the linker.
  52.  
  53. The --enable-targets option adds support for more binary file
  54. formats besides the default.  By default, support for only the
  55. selected target file format is compiled in.  To add support for more
  56. formats, list them as the argument to --enable-targets, separated by
  57. commas.  For example:
  58.  
  59.     ./configure --enable-targets=sun3,rs6000-aix,decstation
  60.  
  61. The name 'all' compiles in support for all valid BFD targets (this was
  62. the default in previous releases):
  63.  
  64.     ./configure --enable-targets=all
  65.  
  66. The binutils can be used in a cross-development environment.
  67. The file etc/configure.texi contains more information.
  68.  
  69. Porting
  70. =======
  71. Binutils-2.5 supports many different architectures, but there
  72. are many more not supported, including some that were supported
  73. by earlier versions.  We are hoping for volunteers to
  74. improve this situation.
  75.  
  76. The major effort in porting binutils to a new host and/or target
  77. architecture involves the BFD library.  There is some documentation
  78. in ../bfd/doc.  The file ../gdb/doc/gdbint.texinfo (distributed
  79. with gdb-4.x) may also be of help.
  80.  
  81. If your system uses some variant of old-style a.out-format,
  82. you can start with a copy of bfd/newsos3.c, and edit it to fit.
  83. (You may also need to tweak bfd/aout-target.h.)
  84. Alternatively, you could use the host-aout.c target.  This is a
  85. special kludge that only works for native (non-cross) configurations.
  86.  
  87. Reporting bugs
  88. ==============
  89. If you can't track down a bug and send suggestions/patches
  90. for fixes, you should probably *not* be using this release.
  91. We have little time to spend tracking down whatever random bugs you
  92. may run into (except for configurations that Cygnus supports for
  93. its customers).  The general place to send bug reports or patches
  94. is to bug-gnu-utils@ai.mit.edu; you can also send them directly to
  95. raeburn@cygnus.com or ian@cygnus.com.
  96.